table of contents
SPU_RUN(2) | Руководство программиста Linux | SPU_RUN(2) |
ИМЯ¶
spu_run - выполняет контекст SPU
ОБЗОР¶
#include <sys/spu.h> int spu_run(int fd, unsigned int *npc, unsigned int *event);
ОПИСАНИЕ¶
Системный вызов spu_run() используется на машинах PowerPC с архитектурой Cell Broadband Engine для получения доступа кSynergistic Processor Unit (SPU). Аргумент fd представляет собой файловый дескриптор, возвращаемый вызовом spu_create(2) и указывающий на определённый контекст SPU. Когда контекст планируется на физическом SPU, он запускается на выполнение начиная с инструкции, на которую указывает значение npc.
Выполнение кода SPU происходит синхронно, то есть spu_run() блокируется на время работы SPU. Если требуется параллельное выполнение кода SPU и кода на основном процессоре или других SPU, то сначала нужно создать новую нить выполнения (например с помощью pthread_create(3)).
При завершении работы spu_run() текущее значение программного счётчика SPU записывается в npc, что позволяет использовать тот же указатель npc в последующих вызовах spu_run().
В аргументе event указывается буфер для расширенного кода состояния. Если контекст SPU создан с флагом SPU_CREATE_EVENTS_ENABLED, то ядро Linux заполняет этот буфер перед возвратом из spu_run().
Код состояния может быть одной (или несколькими) из следующих констант:
- SPE_EVENT_DMA_ALIGNMENT
- Произошла ошибка выравнивания DMA.
- SPE_EVENT_INVALID_DMA
- Попытка выполнить неверную команду MFC DMA.
- SPE_EVENT_SPE_DATA_STORAGE
- Произошла ошибка хранилища DMA.
- SPE_EVENT_SPE_ERROR
- Выполнена недопустимая инструкция.
Для аргумента event допускается значение NULL. В этом случае информация о событиях не будет поступать в вызывающий процесс.
ВОЗВРАЩАЕМОЕ ЗНАЧЕНИЕ¶
При успешном выполнении spu_run() возвращается значение регистра spu_status. При ошибке возвращается -1, а в errno содержится один из кодов ошибки, описанных далее.
Значение регистра spu_status представляет собой битовую маску кодов состояния и необязательный 14-битный код, возвращаемый при выполнении инструкции stop-and-signal SPU. Битовые маски кодов состояний:
- 0x02
- SPU остановлен инструкцией stop-and-signal.
- 0x04
- SPU остановлен инструкцией halt.
- 0x08
- SPU ожидает канала.
- 0x10
- SPU в пошаговом режиме.
- 0x20
- SPU пытался выполнить неверную инструкцию.
- 0x40
- SPU пытался получить доступ к неверному каналу.
- 0x3fff0000
- При наложении этой маски получается код, возвращаемый инструкцией stop-and-signal. Полученные биты корректны только, если установлен бит 0x02.
Если spu_run() не вернул ошибку, то один или более младших восьми битов всегда установлены.
ОШИБКИ¶
- EBADF
- fd не является правильным файловым дескриптором.
- EFAULT
- Задан неправильный указатель в npc или значение event не равно NULL и является неправильным указателем.
- EINTR
- При выполнении spu_run() получен сигнал; см. signal(7). При необходимости, значение npc обновляется до нового значения программного счётчика.
- EINVAL
- fd не является правильным файловым дескриптором, возвращённым spu_create(2).
- ENOMEM
- Недостаточно памяти для обработки страничного сбоя в результате прямого доступа Memory Flow Controller (MFC).
- ENOSYS
- Возможность не предоставляется текущей системой, так как или аппаратура не предоставляет SPU, или не загружен модуль spufs.
ВЕРСИИ¶
Системный вызов spu_run() был добавлен в ядро Linux версии 2.6.16.
СООТВЕТСТВИЕ СТАНДАРТАМ¶
Данный вызов существует только в Linux и реализован только для архитектуры PowerPC. Программы, использующие данный вызов, не переносимы.
ЗАМЕЧАНИЯ¶
В Glibc нет обёртки для этого системного вызова; запускайте его с помощью syscall(2). Однако заметим, что spu_run() предназначен для работы в библиотеках, которые реализуют более абстрактный интерфейс к SPU и не должен вызываться из обычных приложений. Рекомендуемые библиотеки приведены на странице http://www.bsc.es/projects/deepcomputing/linuxoncell/.
ПРИМЕР¶
В следующем примере реализована простая программа, состоящая из одной инструкции SPU и системного вызова spu_run().
#include <stdlib.h> #include <stdint.h> #include <unistd.h> #include <stdio.h> #include <sys/types.h> #include <fcntl.h> #define handle_error(msg) \
do { perror(msg); exit(EXIT_FAILURE); } while (0) int main(void) {
int context, fd, spu_status;
uint32_t instruction, npc;
context = spu_create("/spu/example-context", 0, 0755);
if (context == -1)
handle_error("spu_create");
/* записать инструкцию 'stop 0x1234' в локальное хранилище
памяти SPU
*/
instruction = 0x00001234;
fd = open("/spu/example-context/mem", O_RDWR);
if (fd == -1)
handle_error("open");
write(fd, &instruction, sizeof(instruction));
/* присвоить npc адрес начальной инструкции программы
* SPU. Так как мы записали инструкцию в начало
* файла mem, точка входа будет равна 0x0
*/
npc = 0;
spu_status = spu_run(context, &npc, NULL);
if (spu_status == -1)
handle_error("open");
/* мы должны получить код состояния 0x1234002:
* 0x00000002 (spu остановлен из-за stop-and-signal)
* | 0x12340000 (код stop-and-signal)
*/
printf("Состояние SPU: 0x%08x\n", spu_status);
exit(EXIT_SUCCESS); }
СМОТРИТЕ ТАКЖЕ¶
2007-11-25 | Linux |